.TH GETLOGIN 3 
.SH NAME
getlogin \- get login name
.SH SYNOPSIS
.B char *getlogin();
.SH DESCRIPTION
.I Getlogin
returns a pointer to
the login name
as found in
.IR /etc/utmp .
It may be used
in conjunction
with
.I getpwnam
to locate the correct
password file entry
when the same userid
is shared by several
login names.
.PP
If
.I getlogin
is called within a process
that is not attached to a
typewriter, it returns NULL.
The correct procedure
for determining the login name
is to first call
.I getlogin
and if it fails,
to call
.IR getpwuid .
.SH FILES
/etc/utmp
.SH "SEE ALSO"
getpwent(3), getgrent(3), utmp(5)
.SH DIAGNOSTICS
Returns NULL (0) if name not found.
.SH BUGS
The return values point to static data
whose content is overwritten by each call.
